home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr37 / bblock40.zip / BBLOCK.DOC < prev    next >
Text File  |  1995-03-04  |  5KB  |  136 lines
  1. BaudBlock New User Baud Rate Filter
  2. Copyright (C) 1994-95 Bob Dunnell
  3. Release Version 4.0
  4.  
  5. This program filters out new callers with slow modems.
  6.  
  7. ***Installation***
  8.  
  9. Install this in NEWUSER.BAT and it will run for each new caller.
  10.  
  11. The command line must contain the full pathname of the config file (you can
  12. rename it, but the program has to have it on the command line).  If you use
  13. a nonstandard IRQ, you must put the IRQ after the config file name.
  14.  
  15. For example:
  16.  
  17. bblock bblock.cfg       ;Run program normally
  18.  
  19. bblock bblock.cfg 12    ;Run program using IRQ 12 (sounds weird enough!)
  20.  
  21. Each node will probably need its own configuration file.
  22.  
  23. ***Configuration File***
  24.  
  25. Here is a sample config file:
  26.  
  27. TRIBBS                    <--door type (TRIBBS or GAP)
  28. C:\TRIBBS                 <--path to dropfile, no trailing \
  29. Perotin's Keep            <--BBS name
  30. Lm                        <--Sysop name
  31. 0                         <--Locked baud rate, 0 for none
  32. 2400                      <--Minimum baud rate, 0 to disable
  33. 10                        <--Security level to drop failure to, -1 to disable
  34. c:\tribbs\mwork\joker.dat <--Path to ASCII lockout file to APPEND to
  35.  
  36. Do NOT put a trailing backslash on line 2.
  37.  
  38. Any of the NUMBER lines may be set to zero to disable except for the security
  39. level drop.  To disable this, you must set it to -1.  Line #8 can be left
  40. out, but a blank line must be in its place.
  41.  
  42. If you are using other BBS software than TriBBS, you can NOT set the first
  43. line of the config file to TRIBBS and use TRIBBS.SYS.  If the first line
  44. is set to TriBBS, it uses TriBBS-specific function calls to work some of
  45. its magic.  It will work marginally with DOOR.SYS; in such a case, set the
  46. first line to GAP.
  47.  
  48. BaudBlock requires DOOR.SYS to drop the security level.  It alters DOOR.SYS
  49. and your BBS software is responsible for reading it back in to register
  50. the change.  TriBBS does this.
  51.  
  52. ***Operation***
  53.  
  54. BaudBlock will check your caller's baud rate and compare it to the baud
  55. rates in the config file.  If the caller isn't in the allowed range,
  56. BaudBlock will display a message to the caller, hang up, and add a note
  57. to CALLERS.LOG concerning the incident.  It will also drop their security
  58. level to the level specified in line 7 of the config file if so desired, and
  59. it will append their name to JOKER.DAT or a similar "lockout" file or twit
  60. file if desired.
  61.  
  62. The lockout file MUST EXIST if you specify a filename.  If it doesn't,
  63. BBLOCK will errorout the heck out of you.  If the file isn't there in the
  64. first place, do this at a DOS prompt:  rem>filename and the file will be
  65. created with a length of 0 bytes.
  66.  
  67. It will also greate/append to bblock.log.  Don't like it?  Delete it.  (:
  68.  
  69. ***Registration***
  70.  
  71. Baudblock is freeware.  It is dedicated to my wonderful customers, the
  72. wonderful TriBBS sysops I've encountered, the wonderful other sysops, some
  73. of whom may not be able to run it (them's the bones, switch to a better
  74. software!), and Pete Male, who asked for it and wrote some of it.
  75.  
  76. It is specifically not dedicated to anyone who has questioned my charging
  77. for programs, anyone who has ever questioned anyone's charging for programs,
  78. anyone who has ever advocated piracy, and anyone who is a big jerk (and
  79. you know who you are, too, now feel bad for a while, will ya).
  80.  
  81. Also, to the wonderful classy sysops who have bounced checks off of me.
  82.  
  83. Thanks...for nothing.
  84.  
  85. Now that I've finished being mean...
  86.  
  87. ***Support***
  88.  
  89. See enclosed SUPPORT.DOC
  90.  
  91. ***Acknowledgements***
  92.  
  93. Thanks to Mark Goodwin and Randy Hunt for RMDoor 4.5a and the TriBBS API,
  94. which I (grumble grumble) had to piece together for Pascal. (:
  95.  
  96. TriBBS is a registered trademark of TriSoft and Mark Goodwin.
  97.  
  98. RMDoor is probably a registered trademark of either Mark Goodwin or Randy
  99. Hunt or both, so I wouldn't go using the name for other programs.
  100.  
  101. TriBBS is the best BBS software in existence.  To receive a copy of the
  102. latest public test-drive, freq TRIBBS from Perotin's Keep (1:100/340) at
  103. any time except Fidonet ZMH.
  104.  
  105. ***Disclaimer***
  106.  
  107. BaudBlock is distributed without any type of warranty.  Bob Dunnell assumes
  108. no liability to you or any subsequent users for any damages, including any
  109. lost profits or other incidental or consequential damages arising out of your
  110. use or inability to use Baudblock, even if Bob Dunnell has been advised of
  111. any possibility of such damages.  Bob Dunnell will also not be liable for
  112. any such claim made by a third party.
  113.  
  114. Basically...it has been tested, and it works as far as we know.
  115.  
  116. ***History***
  117.  
  118. Any version marked with a * requires a configuration file change.
  119.  
  120. 1.0* First release.
  121.  
  122. 2.0* Added BBLCHECK.EXE.
  123.  
  124. 3.0* Rewrote the whole shebang from scratch.  Only took about 10 minutes, so
  125.      I'm not promising anything...
  126.  
  127. 3.1  Changed it so it doesn't append someone's name twice if they don't
  128.      have an alias.  Added neat ANSI graphics.
  129.  
  130. 3.2* Release to HOPEFULLY fix this really annoying problem someone
  131.      reported that I can't find.  Took out max baud checking.
  132.  
  133. 4.0  It's free.  Pete Male helped.  It may work.  It may not.  Who
  134.      knows?  Looks like we'll see...added bblock.log creation.  Optimized
  135.      code.  Ate some pizza.  
  136.